home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / cpack.z / cpack
Encoding:
Text File  |  2002-10-03  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ccccppppaaaacccckkkk((((3333GGGG))))                                                            ccccppppaaaacccckkkk((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ccccppppaaaacccckkkk - specifies RGBA color with a single packed 32-bit integer
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ccccppppaaaacccckkkk((((ppppaaaacccckkkk))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 ppppaaaacccckkkk
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _p_a_c_k   expects a packed integer containing the RGBA (red, green, blue,
  17.             alpha) values you want to assign as the current color. Expressed
  18.             in hexadecimal, the format of the packed integer is $_a_a_b_b_g_g_r_r,
  19.             where:
  20.  
  21.                _a_a   is the alpha value,
  22.                _b_b   is the blue value,
  23.                _g_g   is the green value, and
  24.                _r_r   is the red value.
  25.  
  26.             RGBA component values range from 0 to $FF (255).
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      ccccppppaaaacccckkkk sets the red, green, blue, and alpha color components of the
  30.      currently active GL framebuffer, one of normal, popup, overlay, or
  31.      underlay (see ddddrrrraaaawwwwmmmmoooo).  The current framebuffer must be in RGB mode (see
  32.      RRRRGGGGBBBBmmmmoooodddd) for the ccccppppaaaacccckkkk command to be applicable.  Most drawing commands
  33.      copy the current RGBA color components into the color bitplanes of the
  34.      current framebuffer.  Color components are retained in each draw mode, so
  35.      when a draw mode is re-entered, red, green, blue, and alpha are reset to
  36.      the last value specified in that draw mode.
  37.  
  38.      Color component values range from 0, specifying no intensity, through
  39.      255, specifying maximum intensity.  For example, ccccppppaaaacccckkkk(((($$$$FFFFFFFF000000004444000088880000)))) sets
  40.      red to 16#80# (half intensity), green to 16#40# (quarter intensity), blue
  41.      to 0 (off), and alpha to 16#FF# (full intensity).
  42.  
  43.      It is an error to call ccccppppaaaacccckkkk while the current framebuffer is in color
  44.      map mode.
  45.  
  46.      The color components of all framebuffers in RGB mode are set to zero when
  47.      ggggccccoooonnnnffffiiii is called.
  48.  
  49. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  50.      c, drawmo, gRGBco, lmcolo
  51.  
  52. NNNNOOOOTTTTEEEE
  53.      ccccppppaaaacccckkkk can also be used to modify the current material while lighting is
  54.      active (see llllmmmmccccoooolllloooo).
  55.  
  56.      Because only the normal framebuffer currently supports RGB mode, ccccppppaaaacccckkkk
  57.      should be called only while draw mode is NNNNOOOORRRRMMMMAAAALLLL.  Use ggggeeeettttggggddddeeee to determine
  58.      whether RGB mode is available in draw mode NNNNOOOORRRRMMMMAAAALLLL.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.